home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / PROCPS-2.{24 / INSTALL.{_1 < prev    next >
Text File  |  1999-09-17  |  3KB  |  74 lines
  1. INSTALL for procps version 2.0.1
  2. ================================
  3. Please read the NEWS and BUGS files, also.
  4. ==========================================
  5.  
  6.  
  7. Re-compiling the package
  8. ========================
  9.  
  10. You want to examine the first 30 or so lines of the Makefile (up to the
  11. configurability note). The destinations of various things attempt FSSTND
  12. compliance, and are pretty standard.  The CC/LD flags and which libraries you
  13. use for curses/termcap are here also.  It is all annotated there and in a
  14. readily understood format: directories, program to installdir mapping,
  15. sub-packages to build, and compilation options.  A few extra points worth
  16. mentioning are:
  17.  
  18.   o  The SUBDIRS variable is essentially just a list of subdirectories to
  19.      perform a recursive make or make install in.  Right now that's just
  20.      ps; the old xproc has been removed because it was entirely redundant.
  21.   o  There is also an option to build and link against a libproc.so which
  22.      reduces 'ps' and 'top' sizes by a large fraction.  It is on by default,
  23.      so change the value of SHARED if you want.
  24.   o  'make libinstall' will install the library and header files into standard
  25.      system directories for developers of /proc utilities.  There are no
  26.      library man pages yet, but the headers are fairly well documented. 
  27.   o  You may need to change the INCDIRS definition if your system is
  28.      not very standard.  The current definition has been tested to work
  29.      on several different systems, though.
  30.  
  31. Once you are satisfied with the top-level Makefile options (and possibly those
  32. in subdirectories) you compile and install the package like so:
  33. (ignore innocuous `rcsid' defined-but-not-used warnings.)
  34.  
  35.     make distclean # clean-out everything to re-make from scratch
  36.     make           # takes about 0.75 minutes on a PPro 200 with SCSI
  37.     su             # for write/chown-perms on sys dirs
  38.     make install
  39.     ldconfig -v    # update ld.so to use new libproc if SHARED=1
  40.     exit
  41.     make distclean # remove anything that can be rebuilt
  42.  
  43.  
  44. Miscellaneous Notes
  45. ===================
  46.  
  47. COMPATIBILITY
  48.  
  49.     This code is intended for use with Linux 2.0.xx and 2.2.xx.
  50.     Both libc 5 and libc 6 should work.
  51.  
  52. PS/TOP WCHAN FIELD
  53.  
  54.     In past releases, in order to get WCHAN output for ps, you had to
  55.     have a psdatabase for each zImage kernel that you generated from
  56.     the vmlinux unstripped binary with /sbin/psupdate.  With this release,
  57.     you should use the System.map automatically generated by Linus' makefile.
  58.     'ps' and 'top' will first use the contents of an environment variable
  59.     "PS_SYSTEM_MAP" and then look for System.map files along
  60.     the followin search path:
  61.         /boot/System.map-V, /boot/System.map, /lib/modules/V/System.map,
  62.     Here 'V' is the output of "uname -r" and looks like "2.2.0".
  63.     Don't forget the dash! In those same locations, remove psdatabase* files.
  64.  
  65.  
  66. PARTIAL INSTALLATION
  67.  
  68.     If you just want to install one program use the targets
  69.     install_progname and install_progname.X (where X is the man section)
  70.     instead.  E.g.
  71.         make install_ps install_ps.1
  72.     Likewise for component packages, e.g.
  73.         make install_psmisc
  74.